== Required Hardware ===

- ZXTRES, ZXTRES+ or ZXTRES++ (middle board is needed for to load BIT files) 
- microSD card

*NOTE:* It is recommended to have the Spectrum EXP28 090923 core installed as
the main corem as well as, for the use of the middle board, bootstrap v1.03 or
later, USB v01.02 or later, USB v01.02 or later and MIDI v01.08 or later.


== Required software ===

- esxdos (http://esxdos.org) compatible with the version installed in SPI flash
  (the most recent at the moment is 0.8.9)
- zxunocfg "dot" command (available at
  https://github.com/zxtres/dot_commands/tree/main/zxunocfg)
- Bob Fossil's NMI browser
  (http://www.thefossilrecord.co.uk/wp-content/uploads/zx/BROWSE_latest.zip)
- BIT and/or ZX3 plugin installed in BIN/BPLUGINS/BIT


== Installation ==

1. Edit /SYS/CONFIG/ESXDOS.CFG and set AutoBoot=1
2. Depending on where you want the core files to be placed (/CORES, /CORES/BIT 
   or /CORES/ZX3), copy to the card the corresponding autoboot program, renamed
   as /SYS/AUTOBOOT.BAS
3. Enter the advanced BIOS settings and set the speed to 8X, and in Main set the
   startup pause to 0 (Disabled)
4. Copy the BIT and/or ZX3 files to be used into the chosen directory at step 2


== How to create a microSD from scratch ==

1. Format using FAT32

For cards of the appropriate size (32GB or less for FAT32), you can use the
official SD Association formatting tool:
https://www.sdcard.org/downloads/formatter/ 

If you are on macOS, it may also be useful to use these commands afterwards so
that the system does not index the card, deleted files aren't sent to the bin.

----
mdutil -i off /Volumes/<microSD name>
cd /Volumes/<microSD name>
dot_clean . -n && find . -name ".DS*" -exec rm {} ;
cd -
----

2. Download esxdos: http://esxdos.org and copy to the card the directories
   BIN, SYS and TMP

3. Download the ZXTRES utilities from
   https://github.com/zxdos/zxuno/tree/master/SD/BIN and
   https://github.com/zxtres/dot_commands/ and copy at least the following files
   (although it is recommended to use all):
   
   BIN/BPLUGINS/BIT
   BIN/BPLUGINS/MID
   BIN/BPLUGINS/ZX3
   BIN/ZXUNOCFG

4. Rename SYS/NMI.SYS as SYS/NMI.ORG

5. Download Bob Fossil's NMI browser from
   http://www.thefossilrecord.co.uk/wp-content/uploads/zx/BROWSE_latest.zip
   and copy at least this files and directories:

   BIN/BROWSE
   BIN/BROWSE.BIN
   BIN/NMIINIT
   BIN/BPLUGINS/
   SYS/NMI.SYS

6. Follow the installation steps indicated at the beginning of this text


== What is inside the file AUTOBOOT_xxx.BAS?

Just a BASIC program with this content:

  10 .zxunocfg -s3:BORDER 7:PAPER 7:INK 0:CLS
  20 IF INKEY$ ="z" OR INKEY$ ="Z" THEN GO TO 60
  30 .cd <path>
  40 .zxunocfg -s0:.browse
  50 STOP
  60 .zxunocfg -s0:.128
  70 STOP
9999 SAVE *"AUTOBOOT.BAS"LINE 10

where <path> is either /cores, /cores/bit or /cores/zxx3

...and autoboot on line 10
